[アップデート] AWS FIS の実験ログやコンソールに実験エラーの詳細情報が出力されるようになり、トラブルシューティングしやすくなりました

いわさです。

先日いつものように AWS FIS のドキュメントを眺めていたところ新しいトラブルシューティングガイドが追加されていることを確認しました。

AWS CLI のほうも更新されており、こちらの更新履歴からも実験のエラーに関する情報が追加され、よりトラブルシューティングがしやすくなったようです。

https://github.com/aws/aws-cli/commit/2ee54ff7d3e3553763cbe9878b2ffa404eaff5b0

確認してみる

試したみたところ、実験ログでもコンソールでも本機能はどちらでも確認することが出来ました。
実験ログというのは次のアクティビティログを指しています。

https://dev.classmethod.jp/articles/aws-fis-logging/

今回は CloudWatch Logs へ出力するように実験テンプレート作成時に実験ログの出力を構成します。

試しに EC2 の CPU ストレステストを構成し、ターゲット EC2 に該当がない状態の実験を行ってみました。
実行してみると、実験が失敗しました。

画面上部には実験の結果に対するエラーコードのようなものが表示されています。
ちなみにこちらの Learn More リンクをクリックすると次のドキュメントに遷移するのですが、こちらのページは今回のアップデートで新しく追加されたものです。

https://docs.aws.amazon.com/fis/latest/userguide/troubleshooting.html

上記ページではどういう時にどういったエラーコードが表示されるのかが明記されています。
実験ログを確認してみるとエラーコードが出力されるようになっていました。

以下の赤枠部分が今回新たに情報として出力されるようになった部分です。
今までも reason でエラー理由を確認することは出来てはいたのですが、よりトラブルシューティングに役立てる情報がいくつか追加されたという形です。

ターゲットが不正な場合は先程のようにエラーコードが出力されるだけでした。
続いては、実験テンプレートの構成が不正な状態で実験を実行してみたいと思います。

期待どおり実験が失敗しました。
確認してみると今度は実験ステータスのコンテキスト情報が追加されています。
ステータスのコンテキスト情報からはコードとロケーションを確認することが出来ます。
ちなみにコンソール上のコンテキスト情報については実験ログの出力を無効化している場合でも確認が可能です。

理由から SSM ドキュメントの指定に問題がありそうだということがわかりますが、今回追加された情報によってどのアクションに問題がありそうかまで確認出来ます。

ログでも次のように location が追加されており、さらに account_id も出力されています。
クロスアカウントで実験した場合でもアカウントを特定することが出来ますね。

実際にエラー情報に基づいて構成をチェックしてみると documentArn の指定に不備があることがわかりました。

さいごに

本日は AWS FIS の実験ログやコンソールに実験エラーの詳細情報が出力されるようになり、トラブルシューティングしやすくなったので、実際に実験を失敗させて挙動を観察してみました。

従来よりも得られる情報が増えたので、トラブルシューティングの際に役立ててください。